home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / asm / cm_int.exe / CM-INT.DOC < prev    next >
Encoding:
Text File  |  1993-04-10  |  15.3 KB  |  334 lines
  1.  
  2. ;------------------
  3. ;   CM-INT -- Interrupt Service by CMartin -- 2/22/92
  4. ;   Member ASP; CompuServe 72130,1400
  5. ;   The Program CM-INT is released as Freeware.  No contribution is expected.
  6. ;------------------
  7. ;   Intended as a tool kit for 80x86 Assembly Language programmers, this
  8. ;   service may also be useful to high level language programmers whose
  9. ;   language gives them access to the 80x86 interrupt architecture.
  10. ;   This interrupt service installs and stays resident, by including the
  11. ;   command CM-INT in autoexec.bat, and CM-INT.COM in root directory, or by
  12. ;   running CM-INT before any programs that use this interrupt service.
  13. ;   The functions in this service preserve the general purpose registers not
  14. ;   used for data transfer. They also preserve the segment, index and base
  15. ;   pointer registers.
  16. ;
  17. ;   This service is accessed via Int 0C0h, with function number passed through
  18. ;   bh. Description of each function follows:
  19. ;------------------
  20. ;
  21. ;   PAUSE
  22. ;       Function 00h: Pause until specific key is pressed.
  23. ;           Entry:  bl      - ASCII code of keypress required to
  24. ;                            release pause
  25. ;                   bh      - 00h
  26. ;           Return: None
  27. ;------------------
  28. ;
  29. ;   PRINT
  30. ;       Function 01h: Print string at current cursor position.
  31. ;           Entry:  ds:si   - pointer to ASCIIZ source string
  32. ;                   bh      - 01h
  33. ;           Return: None
  34. ;------------------
  35. ;
  36. ;   INPUT
  37. ;       Function 02h: Input a string from keyboard at current cursor position
  38. ;           Entry:  ds:si   - pointer to destination string
  39. ;                   bh      - 02h
  40. ;           Return: None
  41. ;------------------
  42. ;
  43. ;   SCAN (INPUT TO SCREEN) WITH PROMPT AND EDIT
  44. ;       Function 03h: Scan with prompt and editing at current cursor position
  45. ;           Entry:  ds:si   - pointer to ASCIIZ prompt string
  46. ;                   ds:di   - pointer to ASCIIZ destination string for
  47. ;                               data being entered/edited
  48. ;                   al      - data length - desired length of entry string
  49. ;                   ah      - data type -   0:no filtering
  50. ;                                           1:filter non-printable
  51. ;                                           2:numbers (0-9),blanks,and '+-'
  52. ;                                           3:numbers,blanks,and 'eE+-'
  53. ;                                           4:dates (0-9,'/-' and blank)
  54. ;                   bl      - 0=upper and lower case, >0=lower converted to
  55. ;                                  upper
  56. ;                   cl      - blank option- 0:no stripping
  57. ;                                           1:strip leading blanks
  58. ;                                           2:strip trailing blanks
  59. ;                                           3:strip both leading and trailing
  60. ;                   ch      - data window color (prompt field color is same
  61. ;                               backgnd as orig scrn attr, with hi intensity
  62. ;                               white foregnd. On exit, orig scrn attr are
  63. ;                               restored in all fields)
  64. ;                   bl      - 0:Upper and lower case; >0:Converts to upper
  65. ;                   bh      - 03h
  66. ;           Return: bl      - ASCII char code describing which keypress
  67. ;                               terminated data entry. A number of termination
  68. ;                               key combinations with corresponding codes are
  69. ;                               built in for versatility, and are all
  70. ;                               available. The returned byte ASCII character,
  71. ;                               the key combo that produces it, and the
  72. ;                               suggested usage follows:
  73. ;
  74. ;           'I'-<Ctrl><Rtn> {In}        'O'-<Ctrl><F10>-Delete block {Out}
  75. ;           'D'-Down arrow              'U'-Up arrow
  76. ;           'A'-<PgUp>                  'Z'-<PgDn>
  77. ;           'N'-<Ctrl>N-Insert New line 'Y'-<Ctrl>Y-Delete line
  78. ;           'L'-<Ctrl>L-Move Col Left   'R'-<Ctrl>R-Move Column Right
  79. ;           'C'-<Rtn> {Carriage}        'E'-<Esc>
  80. ;           'X'-Error - prompt plus data > 4 lines or off bottom of screen
  81. ;------------------
  82. ;
  83. ;   LINE PRINT
  84. ;       Function 04h: Print to parallel port printer
  85. ;           Entry:  ds:si   - pointer to string to be printed
  86. ;                   cx      - -1 means string is ASCIIZ and is to be printed
  87. ;                                   up to the terminal NULL
  88. ;                             Number other than -1 means print that number of
  89. ;                                   characters. (Permits 0 as a print control
  90. ;                                   character.)
  91. ;                   bh      - 04h
  92. ;           Returns: If print terminated by <Esc>, then leaves keypress in
  93. ;                             keyboard buffer, accessible by int 16h, func 1
  94. ;------------------
  95. ;
  96. ;   32-BIT NUMBER TO ASCIIZ
  97. ;       Function 06h: 32-bit binary number to ASCIIZ string
  98. ;           Entry:  dx:ax   - 32-bit signed binary number to be converted
  99. ;                   ds:si   - pointer to ASCIIZ destination string
  100. ;                   bl      - format for string:
  101. ;                               0=decimal,1=hex,2=octal,3=binary
  102. ;                   bh      - 03h
  103. ;           Returns: None
  104. ;------------------
  105. ;
  106. ;   ASCIIZ TO 32-BIT NUMBER
  107. ;       Function 07h: ASCIIZ string to 32-bit signed number
  108. ;           Operation:  Function scans from rightmost byte in string until
  109. ;                           beginning of field, ignoring illegal characters.
  110. ;                           Terminal h or H means hex;o or O octal; b or B bin
  111. ;           Entry:  ds:si   - pointer to ASCIIZ source string
  112. ;                   bh      - 04h
  113. ;           Returns: dx:ax  - 32-bit signed binary number  (0:0 for overflow)
  114. ;                    bl = 0 (normal return), -1 (overflow)
  115. ;------------------
  116. ;
  117. ;   JULIAN TO CALENDAR DATE
  118. ;       Function 10h: Convert julian date to calendar date.
  119. ;           Operation: Julian date is sent in on ax as unsigned 16-bit
  120. ;               binary number, where julian date 1=calendar date 1/1/1901.
  121. ;               Julian date <1 or >36525 (earlier that 1/1/1901 or later
  122. ;               that 12/31/2000 [12/31/00]) are illegal
  123. ;               Normalized calendar date (mm/dd/yy) is copied as ASCIIZ
  124. ;               string at the pointer provide by ds:si. If julian date
  125. ;               is in illegal range, the string '  /  /  ' is copied.
  126. ;               In addition, the day of the week is returned as a number
  127. ;               0-7 through bh (0=illegal,1=Sunday,etc.).The century
  128. ;               prefix (e.g., 19 for 1956) is passed through bl.
  129. ;           Entry:  bl      - century prefix
  130. ;                               (e.g., 19 is century prefix for 1978)
  131. ;                   ax      - julian date (unsigned 16-bit) (1=01/01/01)
  132. ;                   cx      - number of digits to display year (2 or 4),
  133. ;                               if century prefix is 19.
  134. ;                               (If century prefix not 19, 4 digits will be
  135. ;                               displayed, regardless of contents of cx)
  136. ;                   ds:si   - pointer to ASCIIZ destination string where
  137. ;                               calendar date is to be copied (11 bytes min)
  138. ;                   bh      - 10h
  139. ;           Return: ax      - julian date as unsigned 16-bit number
  140. ;                               (0 if illegal)
  141. ;                   bl      - century prefix
  142. ;                   bh      - day of week (0=illegal,1=Sunday,etc.)
  143. ;                   cx      - year (1980-2099)   (as expected by system set
  144. ;                   dh      - month (1-12)       date service int 21h, 2Bh)
  145. ;                   dl      - day (1-31)
  146. ;------------------
  147. ;
  148. ;   CALENDAR TO JULIAN DATE
  149. ;       Function 11h: Convert calendar date to julian date
  150. ;           Operation: Converse of Function 10h, except that calendar
  151. ;               date string is normalized to 9-byte or 11-byte ASCIIZ form
  152. ;               (mm/dd/yy+terminal NULL or mm/dd/yyyy+NULL, depending on
  153. ;               whether year was 2 or 4 bytes to begin with). If year was
  154. ;               passed in as 2 bytes, default century prefix is 19.
  155. ;               '  /  /  ' is copied to the  string if format is illegal.
  156. ;           Entry:  ds:si   - pointer to ASCIIZ source string (11 bytes min)
  157. ;                   bh      - 11h
  158. ;           Return: Same as Function 10h
  159. ;------------------
  160. ;
  161. ;   GET SYSTEM DATE
  162. ;       Function 12h: Get today's date from system and convert
  163. ;               to julian and calendar date
  164. ;           Entry:  ds:si   - pointer to destination string for cal date
  165. ;                   cx      - number of digits to display year (2 or 4),
  166. ;                               if century prefix is 19.
  167. ;                               (If not 19, 4 digits will be shown.)
  168. ;                   bh      - 12h
  169. ;           Return: Same as Function 10h
  170. ;------------------
  171. ;
  172. ;   SET SYSTEM DATE
  173. ;       Function 13h: Set date in system from ASCIIZ string
  174. ;           Entry:  ds:si   - pointer to source string of form mm/dd/yy or
  175. ;                               mm/dd/yyyy
  176. ;                   bh      - 13h
  177. ;           Return: Same as Function 10h
  178. ;------------------
  179. ;
  180. ;   TIME (SECONDS) TO ASCIIZ STRING
  181. ;       Function 15h: Convert time in seconds to string
  182. ;           Entry:  ds:si   - pointer to destination string for time
  183. ;                               Will be normalized to form hh:mm:ss
  184. ;                   dx:ax   - double word number of seconds since midnite
  185. ;                   bh      - 15h
  186. ;           Return: dx:ax   - double word number of seconds since midnite
  187. ;                   ch      - hours
  188. ;                   cl      - minutes
  189. ;                   bh      - seconds (similar to DOS get time utility,
  190. ;                   bl      - 0         except seconds:100ths in bx)
  191. ;------------------
  192. ;
  193. ;   ASCIIZ STRING TO TIME (SECONDS)
  194. ;       Function 16h: Convert string time to time in seconds
  195. ;                       Procedure normalizes string time to form hh:mm:ss
  196. ;           Entry:  ds:si   - pointer to source string for time
  197. ;                   bh      - 16h
  198. ;           Return: Same as Function 15h
  199. ;------------------
  200. ;
  201. ;   GET SYSTEM TIME
  202. ;       Function 17h: Get system time and convert to string and seconds
  203. ;           Entry:  ds:si   - destination string pointer
  204. ;                   bh      - 17h
  205. ;           Return: Same as Function 15h
  206. ;------------------
  207. ;
  208. ;   SET SYSTEM TIME
  209. ;       Function 18h: Set system time from ASCIIZ string
  210. ;           Entry:  ds:si   - source string pointer (hh:mm:ss)
  211. ;                   bh      - 18h
  212. ;           Return: Same as Function 15h
  213. ;------------------
  214. ;
  215. ;   TIMER
  216. ;       Function 19h: Elapsed time timer
  217. ;           Entry:  bh      - 19h
  218. ;           Return: dx:ax   - Elapsed seconds since previous midnight
  219. ;                   bx      - Elapsed seconds since last call to timer
  220. ;------------------
  221. ;
  222. ;   ASCIIZ STRING COPY
  223. ;       Function 20h: String copy to NULL
  224. ;           Entry:  ds:si   - source string pointer
  225. ;                   ds:di   - destination string pointer
  226. ;                   bh      - 20h
  227. ;           Return: None
  228. ;------------------
  229. ;
  230. ;   ASCIIZ STRING LENGTH
  231. ;       Function 21h: String length
  232. ;           Entry:  ds:si   - source string pointer
  233. ;                   bh      - 21h
  234. ;           Return: ax      - string length
  235. ;------------------
  236. ;
  237. ;   ASCIIZ STRING CONCATENATE
  238. ;       Function 22h: String concatenate
  239. ;           Entry:  ds:di   - pointer to string to which source string is
  240. ;                               to be added
  241. ;                   ds:si   - pointer to source string to be concatenated
  242. ;                               to ds:di
  243. ;                   bh      - 22h
  244. ;           Return: None
  245. ;------------------
  246. ;
  247. ;   ASCIIZ STRING COMPARE
  248. ;       Function 23h: String compare
  249. ;           Entry:  ds:si   - pointer to string 1
  250. ;                   ds:di   - pointer to string 2
  251. ;                   cx      - max number of bytes to compare
  252. ;                   bh      - 23h
  253. ;           Return: ax      - 1 if str1>str2, 0 if str1=str2, -1 if str1<str2
  254. ;                   bx      - unsigned number = position of differing byte
  255. ;------------------
  256. ;
  257. ;   ASCIIZ STRING SWAP
  258. ;       Function 24h: String swap
  259. ;           Entry:  ds:si   - pointer to string 1
  260. ;                   ds:di   - pointer to string 2
  261. ;                   cx      - string length
  262. ;                   bh      - 24h
  263. ;           Return: None
  264. ;------------------
  265. ;
  266. ;   ASCIIZ STRING IMBED
  267. ;       Function 25h: String imbed - Imbeds source string at destination
  268. ;               offset, but does not copy terminal NULL. Good for implanting
  269. ;               ASCII data into a print line.
  270. ;           Entry:  ds:si   - pointer to source string
  271. ;                   ds:di   - pointer to imbed destination
  272. ;                   bh      - 25h
  273. ;           Return: None
  274. ;------------------
  275. ;
  276. ;   ASCIIZ STRING ALL CAPS
  277. ;       Function 26h: All caps - Capitalizes all lower case letters in the
  278. ;               ASCIIZ string pointed to by ds:si; max of cx characters
  279. ;           Entry:  ds:si   - pointer to string to be capitalized
  280. ;                   cx      - maximum number of chars to capitalize
  281. ;                   bh      - 26h
  282. ;           Return: None
  283. ;------------------
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.          ----------------end-of-author's-documentation---------------
  291.  
  292.                          Software Library Information:
  293.  
  294.                     This disk copy provided as a service of
  295.  
  296.                            Public (software) Library
  297.  
  298.          We are not the authors of this program, nor are we associated
  299.          with the author in any way other than as a distributor of the
  300.          program in accordance with the author's terms of distribution.
  301.  
  302.          Please direct shareware payments and specific questions about
  303.          this program to the author of the program, whose name appears
  304.          elsewhere in  this documentation. If you have trouble getting
  305.          in touch with the author,  we will do whatever we can to help
  306.          you with your questions. All programs have been tested and do
  307.          run.  To report problems,  please use the form that is in the
  308.          file PROBLEM.DOC on many of our disks or in other written for-
  309.          mat with screen printouts, if possible.  PsL cannot debug pro-
  310.          programs over the telephone, though we can answer questions.
  311.  
  312.          Disks in the PsL are updated  monthly,  so if you did not get
  313.          this disk directly from the PsL, you should be aware that the
  314.          files in this set may no longer be the current versions. Also,
  315.          if you got this disk from another vendor and are having prob-
  316.          lems,  be aware that  some files may have become corrupted or
  317.          lost by that vendor. Get a current, working disk from PsL.
  318.  
  319.          For a copy of the latest monthly software library newsletter
  320.          and a list of the 4,000+ disks in the library, call or write
  321.  
  322.                            Public (software) Library
  323.                                P.O.Box 35705 - F
  324.                             Houston, TX 77235-5705
  325.  
  326.                                 1-800-2424-PSL
  327.                              MC/Visa/AmEx/Discover
  328.  
  329.                           Outside of U.S. or in Texas
  330.                           or for general information,
  331.                               Call 1-713-524-6394
  332.  
  333.  
  334.